home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / System / CTB Tool Sample / READ ME < prev    next >
Encoding:
Text File  |  1994-02-20  |  2.5 KB  |  50 lines  |  [TEXT/ttxt]
  1. "Connection Tool Skeleton in C" for the Communications Toolbox
  2.  
  3. Copyright © 1994 Peter J. Creath
  4. All Rights Reserved Worldwide
  5. =============================================================================
  6.  
  7. Since the only real CTB reference has its examples written in Pascal (and since I
  8. haven't been able to find any on-disk source code snippets for CTB period), I went
  9. through the steps of how to create a CTB Connection Tool.
  10.  
  11. Unfortunately, I don't have time to fully explain all the intricate details of creating
  12. a CTB tool, and such an effort would be futile, considering that the CTB will shortly
  13. be superceded by the OpenTransport Interface.
  14.  
  15. Again, this isn't a replacement for Inside the Macintosh® Communications Toolbox,
  16. published by Addison Wesley.  There are still all the CTB function calls you need to
  17. know as well as small details of wrapping up the final package.
  18.  
  19. Hopefully this source code will help you on your way and will be of some use.  It
  20. contains all the necessary source files and projects to generate a CTB connection
  21. tool (which is made up of 5 code resources and 1 bundle resource).  I've documented
  22. the source code reasonably well, explaining what needs to be done in a generic sense
  23. in response to the various messages passed to your tool.  I've created a ResEdit
  24. template to aid you in creating the bundle resource.
  25.  
  26. There's still a lot of technical junk you'll need to look up, but this should save you
  27. a few days of work (including translating from Pascal, removing annoying Pascal
  28. idiomatic peculiarities, documenting, etc.)
  29.  
  30. NOTE: This will NOT compile to a fully functional connection tool.  There are many
  31. small details (implementation-specific) which have not been actually written.
  32. They are instead written as inline comments (ie: "Open physical connection layer").
  33. However, all the generic parts are there.  Just customize and go...
  34.  
  35. This source code is freely distributable.  I only ask that you send me a finished
  36. copy (fully registered, free of charge) of anything you create with it.  And if you
  37. create a whole telecom program, using this for some of the tools in it, I'd
  38. appreciate your extending that to the whole shebang.
  39.  
  40. You may not charge for the source code.  You may not restrict anyone's use of this
  41. code in any way (including, but not limited to, copyrighting derivative works).
  42.  
  43. Other than that, enjoy it, and if you have any suggestions or (God forbid!) bug
  44. reports, feel free to e-mail me.
  45.  
  46. Peter J. Creath
  47. February 19, 1994
  48. peterc@gnu.ai.mit.edu (year-round)
  49. pjcreath@phoenix.princeton.edu (school year)
  50.